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MACSbug 

INSTALLATION AND OPERATING INSTRUCTIONS 


1 , 1 INTRODUCTION 

This document describes the Corvus Concept MACSbug Debugger Version 
2.0. It includes a description of the commands for the resident 
firmware monitor, MACSbug, and examples of its use. 


1.2 INSTALLATION PROCEDURES 


NOTE: Before powering the base unit ON or OFF, ensure that there is no 
diskette in the floppy drive. 

a) Power-off the Concept base and display. 

b) Disconnect the keyboard cable and display monitor cable. Open the 
drawer of the base unit and remove the power supply cables connected 
at locations labeled J8 and J1 on the processor board and the memory 
board respectively. Remove any tap cables or interface cards which 
are currently in the drawer. 

c) Lift up on the drawer assembly and completely remove it from 
the base unit. 

d) The procedure to install MACSbug ROMs is different for REV 03 
processor boards and REV 04 processor boards. You can determine 
whether you have a REV 03 or REV 04 by the configuration of the 
Concept boot switches. 

On the REV 03 processor boards, there is a 2-switch microswitch on 
the right side of the processor board, opposite the I/O slots. 

On the REV 04 processor boards, there is a 8-switch microswitch on 
the right side of the processor board, opposite the I/O slots. 



e) Revion 03 Installation Procedures 


1. Locate the Boot ROMS on the processor board at locations U706 (ROM 
OU) and 0711 (ROM OL) , If they are not version 0,5 or laterf 
remove the ROMs at these locations and place the ROM labeled CC 
0,5 H or later in location 0706 and place the ROM labeled CC 0,5 L 
or later in location 0711 on the processor board. 
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2, Place the ROM labeled MACSbug 2,0 L in location 0709 and place 
the ROM labeled MACSbug 2.0 H in location 0708 on the processor 
board. The MACSbug ROM sockets are 28 pin sockets, and the 
MACSbug ROMs are 24 pin devices. The sockets should have the 
top four pin locations unused ( i.e. pins 1,2,27 and 28). 

3, Place both microswitches in the ON position. 
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f) Revison 04 Installation Procedures 


1. Locate the Boot ROMS on the processor board at locations U706 (ROM 
OL) and U710 (ROM OU) . If they are not version 0.5 or latetr 
remove the ROMs at these locations and place the ROM labeled CC 
0.5 H or later in location 0710 and place the ROM labeled CC 0.5 L 
or later in location 0706 on the processor board. 


U708 U709 



2, Place the ROM labeled HACSbug 2.0 L in location 0708 and place 
the ROM labeled MACSbug 2.0 H in location 0709 on the processor 
board. The MACSbug ROM sockets are 28 pin sockets, and the 
MACSbug ROMs are 24 pin devices. The sockets should have the 
top four pin locations unused ( i.e. pins 1,2,27 and 28), 

3. Place raicroswitches 7 and 8 in the ON position. 









g) 


Replace the drawer into the base unit and position the two 
power supply cables along the speaker tray channel to prevent 
chaffing of the cables. Reconnect the power supply cables to 
J8 on the processor board and J1 on the memory board, 

h) Reconnect any tap cables or interface cards originally within the 
drawer, 

i) Power on the display and then the base unit. The Concept will 
emit a beep, and then request input from the user regarding 
the boot device as follows: 

Select the device : (DrF,L,0) i 

D - Debug (MACSbug) 

F - Floppy Disk Drive 
L - Local Disk Drive 
0 - Omninet Drive 

j) Select your normal disk boot option to run a quick check of the 
unit. 

k) If the unit does not complete the boot, check the ROM locations and 
that all pins of the ROMs are installed correctly. Repeat the 
procedure until the system boots. If problems persist, contact 
your local servicing dealer or Corvus Customer Service, 



1.3 COMMMUNICATING WITH MACSbug 


Communication with MACSbug is performed through the two serial ports on 
the back of the Corvus Concept. When used with MACSbug, port 1 has a 
default data rate of 9600 BAUD, parity is disabled and an 8 bit 
character size is assumed. An ASCII terminal must be attached to port 
1 with a null modem cable. This terminal is the MACSbug console. 

MACSbug supports port 2 as a standard RS-232C data terminal connector 
with a default data rate of 4800 BAUD, parity disabled and a 8 bit data 
character size. Port 2 can be used to communicate with a host computer, 
a printer or other serial device. 

This two port communication arrangement allows the Corvus Concept to be 
placed in series with an ASCII terminal and a host computer. The 
transparent mode in MACSbug can be used to bypass the Corvus Concept. 
This allows a program to be created on the host computer using the ASCII 
terminal and then when the program code file is generated, it can be 
downloaded into the Corvus Concept for execution and dubugging. This 
can all be performed without reconfiguring the cabling. 

1.4 OPERATIONAL PROCEDURE 

After the MACSbug ROMs has been installed, MACSbug can be entered 
before the Corvus Concept operating system is booted as follows: 

a. Connect an ASCII terminal to port 1 of the Corvus Concept. 

b. Ensure that the Concept boot switches are both in the ON position. 

c. Power on the Corvus Concept. 

d. Select option D, for Debugger, when prompted. 

MACSbug will initialize and display on the ASCII terminal connected to 
port 1 with the following message: 

MACSBUG 2.0 

* 


If these two lines do not print out, perform the following: 

a. Check to see that the ASCII terminal is attached to RS-232C 
port 1 using a null modem cable, 

b. Ensure that the terminal's BAUD rate is set to 9600, parity is 
disabled and an 8 bit character size is selected. 



1.5 COMMAND LINE FORMAT 


Commands are entered the same as in most other buffer organized computer 
systems. A standard input routine controls the system while the user types 
a line of input. The delete (RUBOUT) key or control H will delete the 
last character entered. A control X will cancel the entire line. 

Control D will redisplay the line. Processing begins only after the 
carriage return has been entered. 


The format of the command line is: 


♦command parameters ;options 


where : 


CO 


mmand 


parameters 


;options 


is the prompt from the monitor. The user does 
not enter this. In the examples given, the lines 
beginning with this character are lines where the 
user entered a command. 

is the necessary input for the command. Each 
command has one or two upper case letters 
necessary in its syntax. In the examples, the 
entire command may be used, but only those 
letters in upper case in the syntax definition 
are necessary. In actual usage, MACSbug converts 
all lower case characters to upper case, 

is the unnecessary part of the command. It is 
given in the syntax definiton only to improve 
readability. If this part of the command was 
actually entered on the command line, it would be 
ignored. 

depends upon the particular command. Data is 
usually in hex but most printable ASCII 
characters may be entered if enclosed in single 
quotes. The system also supports a limited 
symbolic feature allowing symbols to be used 
interchangeably with data values, 

modifies the nature of the command. A typical 
option might be to disregard the checksum while 
downloading. 



1.6 MACSbug COMMAND SUMMARY 
COMMAND 


DESCRIPTION 


SECTION 


reg# 

reg* hexdata 
reg* 'ASCII’ 
reg*: 
class 
class: 

Print a register 

Put a hex value in the register 

Put hex-equivalent characters in register 

Print the old value and request new value 

Print all registers of a class {A or D) 

Sequence through-print old value request new 

1.6.1 

DM start end 
SM address data 

Display memory, hex-ASCII memory dump 
Set memory with data 

1.6.2 

OPen address 

Open memory for read/change 

1.6.3 

SYrabol NAME value 

Define and print symbols 

1.6.4 

W* 

W*.len EA 
M* data 

Print the effective address of the window 
Define window length and addressing mode 
Memory in window, same syntax as register 

1.6.i; 

Go 

Go address 
Go TILL add 
BReakpoint 
BR add: count 
BR -address 
BR CLEAR 

Start running from address in program counter 

Start running from this address 

Set temporary breakpoint and start running 

Print all breakpoint addresses 

Set a new breakpoint and optional count 

Clear a breakpoint 

Clear all breakpoints 

1.6.6 

TD 

TD reg*. format 
TD Clear 
TD ALI 

Print the trace display 

Put a register in the display 

Take all registers out of the display 

Set all registers out of the display 

1.6.7 

TD A.l D.l L.c 

Set register blocks or line separator 

1.6.B 

T 

T count 

T TILL Address 
:*(CR) 

Trace one instruction 

Trace the specified number of instructions 

Trace until this address 

Carriage return-trace one instruction 

1.6.9 

OFfset address 

Define the global offset 

1.6.10 

CV decimal 
CV $hex 
CV valuefValue 

Convert decimal number to hex 
Convert hex to decimal 
calculate offset or displacement 

1.6.11 

REad;=>test 

VErify?=»text 

Expect to receive S records 
Check memory against S records 

1.6.]2 

CAll address 

JSR to user utility routine 

1.6.13 

P2 

*. .data 

Enter transparent mode 
Transmit command to host 

1.6.)4 

CTL-A 

CTL-D 

The control A key ends transparent mode (default) 
The control D key redisplays the line 

CTL-H 

CTL-X 

The control H key deletes the last character 
The control X key cancels the entire line 

entered 



1.6.1 Set and Display Registers 

68000 REGISTER MNEMONICS DESCRIPTION 


REGISTER DISPLAY 


D0,D1,D2,D3,D4,D5,D6,D7 

A0,A1,A2,A3,A4.A5,A6,A7 

PC 

SR 

SS 

US 

COMMAND FORMATS 

reg# hexdata 
reg# 'ascii data' 
reg#: 
reg# 

class (where class=D or 
class: 


EXAMPLES 

*A5 123 
*A5 

A5=00000123 
*D4 FFPFFP 
*D0: 

D0=0000000 ? 45FE 
*D: 

D0=000045FE ? 9EAB3 

D1=00000000 ? (CR) 

D2=00000000 ? (CR) 
D3=00000000 ? (CR) 
D4=00FFFFFF ? (CR) 
D5=00000000 ? 55555 
D6»00000000 ? (CR) 
07=00000000 ? (CR) 

*D 

DO=0009EAB3 01=00000000 
D4=OOFFPFPF 05=00055555 
♦PC: 

PC=0008B3 ? 2561 
♦SR 0 
♦A7 4321 
♦US 

US=00004321 
♦SS FFC 
♦SR 2000 
♦A7 

A7=OOOOOFFC 


Data registers 
Address registers 
Program counter 

Status register (condition codes) 

Supervisor stack pointer (A7 in supervisor 
mode) 

User stack pointer (A7 in user mode) 
DESCRIPTION 

Put a hex value into register 'reg#' 

Put hex value of ASCII into register 'reg#* 
Print register value and request in new value 
Print register value 

A) Print values of all registers in the class 

Cycle through all registers in the class 
printing old value and requesting new value 

COMMENTS 

Set address register A5 to hex value 123 
Command to print the value of register A5 
Computer response 
Set a data register 

Command to print old value and take in new value • 
Computer prompts with old value; new value entered 
Command to cycle through all data registers 
Change value of register DO from 45 FE to 9EAB3 

Carriage return (null line) means the value 
remains the same 


Change register D5 to a new value 


Display all -data registers 
D2«00000000 D3=00000000 
D6=00000000 D7»00000000 

Display and request input for program counter 
Set the program counter to new value 
Set status register to zero (user mode) 

Set address register (same as DS now) 

Display user stack pointer 

Set supervisor stack pointer 
Set status register to supervisor mode 
Print A7 which is now the SS register 
Initialize system stack pointer value from 
MACSbug 



MEMORY DISPLAY 


1,6,2 Display and Set Memory 


COMMAND FORMAT 


DESCRIPTION 


DM start end 

DM start count 
DM2 start end 
SM address data 
SM address 'ASCII' 
SM address data N 


Display Memory in hex and ASCII where start 
< end 

Where start > count 
Send output to PORT 2 
Set Memory to hex 
Set Memory to ASCII 

The 'N' as the last character means start a 
new line; the system will prompt with the 
current address 


EXAMPLES 


COMMENTS 


*SM 92000 'ABC 
*SM 92003 4445 46 'G' 

*DM 92000 92010 

0092000 41 42 43 44 45 46 47 00 
0092010 00 00 00 00 00 00 00 00 


Set memory to some ASCII data 
Set some more locations 
Command to dump memory 

00 00 00 00 00 00 00 00 ABCDEFG.., 
00 00 00 00 00 00 00 00 


In the following usage of the DM 
command the second number is smaller than 
the first so it is decoded as a count. 

*DM 92003 12 

0092003 44 45 46 47 00 00 00 00 00 00 00 00 00 00 00 00 DEFG 

0092013 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 


*SM 9100n 1 9*^ 4*^6 7890 ABCDE 12345678 Size can be up to 8 characters 
*DM 91000 

091000 01 23 04 56 78 90 OA BC DE 12 34 56 78 00 00 OO 

*SM 91000 'TABLE • 00005678 N Use of the 'N' parameter to 

start a new line 

0009100C? 'START • 00023456 


*DM 91000 

20 









091000 54 

41 

42 

4C 

45 

20 

20 

20 

00 

00 

091010 54 

20 

20 

20 

00 

02 

34 

56 

00 

00 

♦OFFSET 2030 









♦DM 91000 
093030 FF 

FF 

FF 

FP 

FF 

FF 

FF 

FF 

FF 

FF 

♦SM 91005 

1234 N 




Global 

00093037 ? 

AB 








♦DM 91000 
093030 FP 

FF 

FF 

FP 

FP 

12 

34 

AB 

FF 

FF 


56 78 53 54 41 52 TABLE. .. .VxSTAR 
00 00 00 00 00 OO T 4V 

Global offset will be added to 
command parameters 
FP FF FF FP FP FP 

offset added to address 91005 


FF FP FF FP FF FF 


*SM 20000 AB CD EF 
ERROR 


Trying to set ROM 
Error message 



1,6.3 Open Memory for 
COMMAND FORMAT 

Read/Change 

DESCRIPTION 

OPEN MEMORY 

Open address 
SUBCOMMAND FORMAT 

Open memory 
mode 

at specified address and enter subcommand 

(CR) 


Go to next 

sequential location 



Go to previous location 

= 


Stay at same location 

EXAMPLES 


Return to MACSbug(exit the OPen command) 
USER 

ADDRESS 
♦OP EOO 

CONTENT 

ENTERS 

COMMENTS 

Open memory location EOO 

OOOEOO 

= FF? 

12 

User enters data and system goes to next 
location 

OOOEOl 

= AB? 

(CR) 

Carriage return means go to the next 
location 

000EO2 

= 44? 

34" 

UP arrow means go to previous location 

OOOEOl 

= AB? 


Can be entered without data 

OOOEOO 

= 12? 

77 = 

Equal sign means stay at same address 

OOOEOO 

= 77? 

= 

Can be used without any data 

OOOEOO 

* 

♦OP 21234 

= 77? 

• 

Period means return to MACSbug 
Returns to command level 

021234 

♦♦NO CHANG £♦♦ 

= FF? 

99 = 

Example of trying to change ROM 
Warning message 

021234 
♦OP EOO 
OOOEOO 00? W 

= FF? 

• 

Does not abort command 
Enter invalid character 

W IS NOT A HEX 
* 

DIGIT 


Print error message 
Command is aborted 



1.6,4 Define and Print Symbols 


SYMBOLS 


COMMAND FORMAT DESCRIPTION 


symbol name hex value 


SY -name 
SY name 

SY value 

SY 


Put a symbol in the symbol table with a hex value 
or assign a new value to a previously defined 
one. NAME can be 8 characters long, consisting 
of :A-Z, 0-9, (period) , and $(dollar sign). It must 
begin with lettet (A-z) or period. 

Remove a symbol from the symbol table 
Print the current value of the symbol (absolute) 
Print the first symbol with the given value 
Print the sorted symbol table 

NOTE 


Offset is not used by this command. Some commands 
recognize the words TILL, ALL. and CLEAR as key words 
and will not interpret them as symbols. 


EXAMPLES 


COMMENTS 


*SY XYZ 5000 
*SY-XYZ 
XYZ=5000 
*SY XYZ 123 
*SY ABC34 2500 
*SY Z 17, RTS XYZ 
*SY-123 
XYZ=123 

*SY B$67ABC 4300 
*SY RFLAG 200 
*SY MVP2 9990 
*SY 

ABC34 00002500 
RFLAG 00000200 


Puts the symbol in the table 

Command prints out the symbol’s current value 

Change a symbol's value 
Define another symbol 

Define a symbol with value from another symbol 
Print first symbol with value of 123 

Define some more symbols 


Print the sorted symbol table 
B$67ABC 00004300 MVP2 00009990 

XYZ 00000123 Z17,RT5 00000123 


*SY TTT 

T IS NOT A HEX DIGIT 
*SY 567 
00000567-567 


Print a value for symbol not in table, when not 
found, it tries to convert parameter to number 
Attempt to print value for symbol not in table 


SYNTAX EXAMPLES 


COMMENTS 


*BR MVP2 
♦CALL RFLAG 
*PC ABC34 
♦DM M7P2 10 


Set a symbolic breakpoint 
User define routine 
Set a register 
Display some memory 


examples op key WORDS IN COMMANDS 


♦BR CLEAR 

♦GO TILL Z17,RT5 

♦T TILL ABC34 


The word CLEAR is not considered ^ symbol here 
The word TILL is part of the comm nd 
The word TILL is part of the command 



1.6.5 Displaying and Accessing Memory through Windows 


WINDOWS 


A "window" is an effective address through which the user can "see" memory, 
the windows are labeled WO to W7 and are defined using the syntax listed 
below. The windows address corresponding memory locations labeled MO to M7 
which use the same syntax as registers. These memory locations can be 
examined, set or defined in the display the same as a register. 


COMMAND FORMAT 


DESCRIPTION 


W# Print the effective address of a given window 

Wt.len EA Define a window size and effective address 

# is the window number 0 to 7 
len is the length in bytes 
l=bytej 2=wordj 3«3 bytes; 4=long word 
0=close a window (undefine it) 

EA is Effective Addressing mode 
(see EA SYNTAX EXAMPLES in table below) 
Pseudo registers have same syntax as registers 

M# data or 'ASCII' 


EA SYNTAX EXAMPLES DESCRIPTION 


FEB 

(A6) 

-100(A6) 

-10(A6,D2) 

- 100 (*) 

10(*,D4) 


Absolute address in hex 

Address register indirect in hex 

Indirect with displacement in hex 

Indirect with index and displacement in hex 

Program counter with displacement in hex 

Program counter with index and displacement in hex 


EXAMPLES 


COMMENTS 


*W3.4 (A6) 

*A6 92000 
*W3 

W3.4 (A6)=92000 
*M3 87342 
*M3 

M3=00087342 
*DM 92000 

092000 00 08 73 42 00 

*TD CLEAR 

*TD PC. 2 A6.3 M3.1 

*TD 

PC-00A2 A6=-092000 M3 
*W3.2 (A6) 

*TD M3. 2 
*TD 

PC=00A2 A6=092000 M3^ 
*W0.1 10(*,A6) 

*W0 

WO.l 10(*,A6)=920B2 

*W3.0 

*TD 

PC=00A2 A6=092000 


Define a window: 

Enter a value for the address register indirect 
Print the effective address of a window 

Set memory through the window 

Command to print memory through the window 

Display a line of memory 

00 00 00 00 00 00 00 00 00 00 00 . .SB 

Clear all registers from the trace display 
Define some registers for the display 
Command to print the trace display 
42 NOTE:W3.4 and M3.1 only lowest byte displayed 
Change width of window 
Change width of display 


0008 


Define a new window :PC+A6+10 
Print effective address of window WO 

Close window W3, undefine it 

Closed/undefined windows are not in the display 



»nd Breakpoints 


GO, BREAKPOINT 


COMMAND FORMAT 


DESCRIPTION 


GO 

Go address 
Go TILL address 

BR 

BR address 
BR -address 
BR addresstcount 
BR CLEAR 


Begin execution at address in PC register 
Begin execution at this address 

Set a temporary breakpoint at the address and run 

until a breakpoint is encountered 

Print the address of all breakpoints (8 maximum) 

Set a breakpoint at this address 

Remove the breakpoint at this address 

Set a breakpoint at this address with a count 

Remove all breakpoints 


EXAMPLES COMMENTS 

(see example program in section 1.7) 


*PC EOO 
*TD CLEAR 
*TD PC. 2 DO.l 
*TD 

PC=0E00 D0=00 
*G TILL E08 
PC»0E08 D0=04 
*BR 0E02 
*G 

PC=OE02 D0=01 
*BR E08:4 
*BR 

BRKPTS= 0E02 0E08;4 
*G 

PC=0E00 D0=4 
PC=0E02 D0=1 
*BR 

BRKPTS= 0E02 0E08:3 
*BR -E02 
*G 

PC=0E08 D0=4 
PC=»0E08 D0=4 
PC=0E08 D0=4 
*BR 

*BRKPTS=s 0E08 

*BR EOS: 2 
*G 


Set program counter to starting address 

Set trace display format 
Print trace display 

Run until address 

System displays when it stops 

Set a breakpoint 

Run until breakpoint 

Trace display 

Set a breakpoint with a count 
Print the breakpoints 

Run 

Decrements count, prints display, continues 

Stops at breakpoint with zero count 

Print the breakpoints 

Count has been decremented by one 

Remove a breakpoint 

Run 

Count from 3 to 2... 

• . • 2 to 1 » . a 

...1 to 0 and it stops here 
Print the breakpoints 

No count for this breakpoint, does not reset 
back to count value 
Reseting count 


PC»0E08 D0»4 
PC=OE08 D0=4 
♦BR EOO 
*G EOO 

PC=0E08 D0=*4 
*SY JUMPER EOA 
♦BR JUMPER: 5 

♦BR 123456:7897 11 22 33 
TABLE FULL BRKPTS* EOS EOO EOA: 5 123456: 7897 11 22 33 44 


Count 2 to 1 

Count 1 to 0 and stop 

Set another breakpoint 

Start running from EOO, bypass breakpoint at 
starting address and stop at next breakpoint 
Define a symbol 

Set a breakpoint at a symbolic address 
44 55 66 Try to overflow table (holds 8) 



1.6.7 Set the Trace Display Format (Individual Registers) 


TRACE DISPLAY 


COMMAND FORMAT DESCRIPTION 


TD Print the trace display 

TD Clear Take everything out of the display 

TD ALI Put all registers in display (see section 3*6.8) 

TD req#. format Add or delete registers in display where reg# is 

D0-D7,A0-A7.W0-W7.M0-M7,PC.SR.ttr.rs.a,D, or L (see 
the next section). 

Format can be 0,1, 2,3,4. Z,DrRr or S. 


0“ remove the item from the display 
l,2,3.4=print this number of bytes as hex 

-character Sr include all leading zeros 
Z»slgned long word hex with zero suppress 
Designed long word decimal with zero suppress 
R=subtract offset (see OFfset command) then print 
-with Z format with letter 'R* at end 
Sasearch symbol table for 4 byte value, if found 
print symbol name as 8 characters, if not found 
print hex value as 8 characters 


EXAMPLES 


COMMENTS 


*PC 0 

*D1 5 

*A6 8F 

*TD CLEAR 

*TD PC. 3 Dl.l 

*TD 

PCaOOOOOO Dl=05 
*TD PC.O A6 
*TD 

Dl=05 A6=0000008F 
*W3.2 92000 
*M3 20 
*TD M3. 2 
*TD 

DlaOS A6»0000008F M3a0020 

*TD A6.1 D1.3 M3.Z 

*TD 

Dl=000005 A6a8P M3=20 
*TD Dl.R M3.D 
♦OFFSET 12345 
♦TD 

Dla-12340R A6a8F M3»32 
♦SY TABLE 8F 
♦TD A8.S M3.0 
♦TD 

D1=-12340R A6=TABLE 

♦A6 123 

♦TD 

Dla-12340R A6=00000123 


Initialize registers for example below 
Initialize registers for example below 
Initialize registers for example below 
Turn off all the registers in display 
Define PC as 3 bytes and D1 as one 
Command to display 
This is the trace display 

Remove PC and add A6 which defaults to 4 bytes 
Display 

Display with two new registers 
Define a window 

Set value of memory pseudo register 

Add a memory pseudo register to the display 

Display 

New display 

Change length of registers already in display 
Display 

New display, M3 now suppresses leading zeroes 
D1 is relative and M3 is decimal 
Set the offset (see OFfset command] 

Display 

5-off set“-123 40 r; 20 hex =* 32 decimal 
Define a symbol (see SYmbol command) 

Make A6 print symbol if value is in table 

Prints symbolic value 

Set AS to a value NOT inm symbol table 

A6 prints value with 4 byte format 



1,6,8 Set the Trace Display Format (Blocks of Registers) 


TRACE DISPLAY 


COMMAND FORMAT 


DESCRIPTION 


TD CL ear 
TD D,1 
TD A,1 


TD L. character 
TD ALl 


EXAMPLES 


Take everything out of the display 

Put all data registers in display as a block 

Put all address registers in display as block 

(for D,1 and A,1 the format is fixed at 4 

bytes) 

Define a line separator at the end of display 
(.0 will reverse A.l, D,l, and L. char commands) 
Same as keying: 

♦TD PC, 3 SR,2 US. 4 SS.4 D.l A.l L.- 
does not affect other registers and windows 
that have been previously defined to 
display 

CnMMKNTJ? 


♦TD clear Clear the display 

♦TD D.l Define all data registers in a block 

♦TD Print the trace display 

D0=>00000000 D1=>00000000 D2=>00000000 D3»00000000 
D4»00000000 D5=i00000000 D6»00000000 D7»00000000 
♦TD CLEAR 

♦TD A.l Define all address registers in a block 

♦TD 

AOaOOOOQOOO A1=>00000000 A2=>OOOOOQOO A3»00000000 
A4=00000000 A5«00000000 A6=00000000 A7=OOOOOFFC 

♦TD L,3 Define a line separator (a row of '@') 

*TD 

A0»00000000 Al^OOOOOOOO A2»00000000 A3=00000000 
A4=00000000 A5=»00nnnn00 A6»00000000 A7=000nnppr 

♦TD L,& Define a line separtator (a row of '&') 

♦TD 

A0»00000000 Al^OOOOOOOO A2»00000000 A3»00000000 
A4»00000000 A5»00000000 A6=00000000 A7=0000npFC 
&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& 

♦TD ALL Turn on commonly used registers,. , 

♦TD this is also the default or reset condi i ; on 

PCaOOOOOO SR-2000 OS«00007F00 SS-00007PFE 

DO^OOOOOOOO D1>00000000 D2»00000000 D3s00000000 

D4»00000000 D5=>OOOOOQOO D6»OQOOOQOQ D7»OQOOOOOO 

AOAOOOOQOOO AIaOQOOOOOO A2aOOOOOOOO ASaQOOOOOOO 

A4aOOOOOOOO ASaQOOOOOOO ASaOOOOOOOO A7aOOOOOFFC 



1.6.9 Tracing 
COMMAND FORMAT 
Trace 

Trace count 
Trace TILL address 

:*(CR) 


EXAMPLES 

(see example program 

*TD CLEAR 
*TD PC. 2 DO.l 
*DM EOO 

OOOEOO 70 01 70 02 70 

*PC EOO 

*TD 

PC=OEOO D0=00 
*T 

PC=0EO2 D0=01 
:*(CR) 

PC=0E04 D0=02 
:*T3 

PC=0E06 D0=03 
PC=0E08 D0=04 
PC=0EOA D0=05 
♦T-TILL E04 
PC=0E00 D0=05 
PC=0E02 D0=01 
PC=0E04 DO-02 


TRACE 


DESCRIPTION 

Execute one instruction and print trace display 
Trace specified number of instructions 
Trace to the given address 
(breakpoint will stop the trace) 

A colon (:) before the prompt indicates a 
special trace mode is in effect, a carriage 
return will trace the next instruction 

COMMENTS 
in section 1,7) 

Remove all of trace display 
Display only PC and DO 
Example program in memory 
03 70 04 70 05 4E P8 OE 00 FF PF 
Set the program counter 
Print the trace display 

Trace one instruction 

Special prompt appears, carriage return will 
trace the next instruction 
Trace three instructions 


Trace till instruction at address E04 



1.6.10 Offset 


OFFSET 


The 68000 instruction set lends itself to relocatability and position 
independence. A general purpose, global offset feature has been provided. 
The single offset address applies to all of the commands listed below. 
Registers displayed in the trace display may have the offset subtracted by 
using R as the format. See paragrpah 1.6.7 on trace display. 

The offset may be overriden by entering a comma and alternate offset. All 
commands do not use the offset but any number can be forced to be relative 
(have the offset added) by entering an R as the last character of the 
number . 


WARNING: This is a very simple offset feature and may not be able to solve 

complex relocation problems. The user is encouraged to experiment with the 
global offset and the window features to determine their limitations and 
usefulness in a particular application. 


COMMAND FORMAT 


DESCRIPTION 


OFfset Display offset 

OFfset hex value Set the offset to a given value 

OFfset 0 Set the offset to zero - begin absolute 

addressing 

command data, alternate Disregard offset, add alternate offset to data 

command data. Data is absolute, no offset added 

command data, OR Used in commands that do not normally use 

offset, adds offset to data 


The offset affects the following commands: 


TD reg.R Trace display, substract offset from register value 

BReakpoint Set breakpoint (display is in absolute) 

Go All addresses 

SM All addresses 

DM All addresses (display is in absolute) 

REad All addresses 


EXAMPLE 


COMMENTS 


*PC 2010 
*TD PC.R 
*TD 

PC=2010R 
*OF 2000 
*TD 

PC=10R 
*BR 6 
*BR 

BRKPTS=«2006 
*BR 24,3000 
*BR 

BRKPTS=*2006 3024 


Set the program counter 

Set trace display. R means nex long word minus offset 
Display 

Displayed relative to offset (zero now) 

Set the offset ot 2000 
Display 

PC - offset =» 2010-20 00 = 10 Relative 

Set a breakpoints hex data+offset = 6+2000 = 2006 

Display breakpoint 

Breakpoints are always displayed as absolute hex 
Set a breakpoint with alternate offset 24+3000 



1 .6.11 Number Base Conversion 


NUMBER CONVERSION 


COMMAND FORMAT DESCRIPTION 

CV decimal or & decimal Decimal to hex conversion 

CV $hex Hex to decimal conversion 

CV symbol Use value from syinbol table 

CV value, offset Calculate offset or displacement 

NOTE 


This command DOES NOT automatically use the global 
offset. The default base for this command only is 
decimal. All numbers are signed 32 bit values. 


EXAMPLES 


COMMENTS 


*CV 128 
$80=&128 
*CV $20 
$20=&32 
*CV -$81 

$FPPPPF7F=-S81=-&129 

*CV $444,111 

$555=&1365 

*CV $444,-111 

$333^5819 

*SY TEN &10 

*SY THIRTY &30 

*CV TEN 

$A=&10 

*CV -TEN 

$FFFFFFF6=-$A=-&10 
*CV THIRTY, -TEN 
$14=620 
*OF 2000 
*CV $123R 

$2123=68483 
*CV TEN, OR 
$200A«68202 


Command to convert decimal to hex 
Computer response 
Hex to decimal 

Negative numbers 

Adding an offset (second number's base 
defaults to first number's) 

Subtracting an offset (forward displacement) 

Defining a symbolic decimal constant 

Command can be used with symbols 


Define a global offset 
R at the end 

of a number means add the 
global offset 
Symbolic relative 



1.6.12 Download and Verify 


DOWNLOAD 


COMMAND FORMAT DESCRIPTION 

REad;-CX «text Load S records - default PORT 2 

option “C means ignore checksum; 
option X means display data being read; 
if equal sign is used in this command line then 
everything after it is sent to PORT 2 
VErify;=text Verify memory with S records - print difference; 

verify does not use checksum 


NOTE 


These commands use the offset. No attempt is made to 
control the host transmissioins. For the REad and VErify. 
any line received not beginning with the letter S is ignored 
(see appendix A for S record formats). If an error occurs 
causing the system to take the time to print out an error 
messager one or more lines sent during the error message may 
have been ignored, 

EXAMPLE COMMENTS 


*READ;=COPY FILE.MX,#CN 
*DM EOO 10 


Download from an EXORciser. 
Check to see if data was loaded 


OOOEOO 70 01 70 02 70 03 70 04 70 05 4E F8 OE 00 FP FF 


♦VERIFY ;=COPY FILE.MX,#CN 
*SH EOS FF 
*DM EOO 

OOOEOO 70 01 70 02 70 FP 70 04 70 05 4E F8 OE 00 FF FF 
♦VERIFY ;=COPY FILR.MX.#CN 
SlllOEOO 03 

♦RE;=--COPY FILE2.MXr#CN 


Normal verify returns with prompt 
Deliberately change memory to show verify 
Verify that 03 was changed to FF 


Displays only nonmatching data bytes 
Example of file with bad character 
SlliOE007001700270/3700470054EF80E0049 NOT HEX=/ 

♦RE;=COPY FILE2.MX,#CN Example of file with bad checksum 

S1110E00700170027003700470054EF80E0039 CHKSUM»49 

♦RE;=COPY FILE.MX, #CN Normal read returns with prompt 

♦OF 5423 

*RE;=COPY FILE.MX, #CN Download with offset 

♦DM 1000 Display memory » adds offset to parameters 

006423 70 01 70 02 70 03 70 04 70 05 4E F8 OE 00 FP FF 



1.6.13 The CALL Command 


CALL 


The call command can be used to add commands. This is done by writing 
a subroutine which ends with an RTS. 

The call command does not affect the user's registers and is not to be 
confused with the GO command. The user may use a symbol as the 
command parameter instead of an absolute starting address. Registers 
A5 and A6 point to the start and end of the I/O BUFFER (see RAM 
equate file listing, paragraph 1.11) so the user may pass additional 
parameters on the comand line. 


COMMAND FORMAT 
CALL address 

EXAMPLE 


DESCRIPTION 

JSR to user subroutine, routine must 
end with RTS 

COMMENTS 


♦CALL 3000 23 45 ZZ 


*SY FIXUP 2300 
♦CALL FIXUP 


JSR to user routine at location 3000 
note that 23 45 & ZZ may be additional 
parameters that the user's subroutine 
will decode and are ignored by MACSbug 
Define a symbol as absolute address 2300 
JSR to symbolic address 



1.6.14 Transparent Mode and Host Communication 


TRANSPARENT 


COMMAND FORMAT 
P2 [char] 


(control A) 

. .data. . . 

EXAMPLES 

MACSBOG 2.0 
*P2 

‘TRANSPARENT* EXIT’ 
} 

(CONTROL A) 
♦MACSBDG* 

**MAID 

**E800; G 

*P2 & 

‘TRANSPARENT* EXIT’ 
}& 


DESCRIPTION 

Enter transparent mode: The optional user 
defined exit character tchar], defaults to 
control A ($01). This command logically 
connects port 2 (host) and port 1 (console) . 

Host transmissions go directly to the console 
and console transmissions go directly to the 
host. The BAUD rates on the two ports may be 
the same or port 2 may be less. 

Default character to end the 
transparent mode, alternate character 
may be defined in P2 command 

Asterisk- ‘r as the first character of 
the console input buffer means transmit 
the rest of the buffer to the host 
(PORT 2) , the BAUD rates of the two 
ports (1 and 2) do not have to be the same. 

COMMENTS 

Start up or reset condition 
Command to enter transparent mode 
$01 MACSbug prints this, the EXIT=$01 

means to exit this mode, enter control A 

User talks direct to the host, uses the 
editor, assembler, etc. 

Ends the transparent mode 

MACSbug prints this and system is ready 
for new command 

System prompts with * and user enters 
• *MAID» 

Everything after the second * is sent 
to the host 

(NOTE: the BAUD rates do not have to be the same) 

Enter transparent mode, is the exit 

character 

$26 Displays exit character (&) as hex value 26 

User exits transparent mode by entering 


♦MACSBUG* 


Command mode prompt 



1.7 EXAMPLE OP COMMAND PROCEDORES 


MACSBOG 2.0 Start up condition 

*P2 MACSbug prompts \fith * user enters P2 to 

enter transparent mode. 

♦TRANSPARENT* EXITa$01 Message printed to indicate user is now 

directly connected with host system 

- NOTE: The following example is using a MOTOROLA EXORciser host system - 


MAID 
♦*E800;G 
MDOS3.0 
»MACS FILE;CO 


FILE 

1 

2 

3 


MC68000 ASM REV= 


Boot up MDOS 


Assemble a source file (see M68000 Cross 
Macro Assembler manual) 
l.OC - COPYRIGHT BY MOTOROLA 1978 


EXAMPLE PROGRAM FOR 68000 MACSBOG 
TO DEMONSTRATE TRACING, BREAKPOINTS, 


AND GO 


4 


OOOOOEOO 


ORG $0E00 



5 

OOOEOO 

7001 

START 

MOVE.L #1,D0 

1 

LOADED INTO 

6 

000EO2 

7002 


MOVE.L #2, DO 

2 


7 

000E04 

7003 


MOVE.L #3, DO 

3 


8 

000EO6 

7004 


MOVE.L #4, DO 

4 


9 

000EO8 

7005 


MOVE.L #5, DO 

5 


10 

OOOEOA 

4EF80E00 

JUMPER 

JMP START 


DO IT AGAIN 

11 




END 




♦♦♦♦♦♦TOTAL ERRORS 0-0 


SYMBOL TABLE 

JUMPER OOOEOA START 


=COPY PILE. MX, #CN 
S00600004844521B 

S1110E00700170027003700470054EP80E0049 

S9030000FC 


MDOS command to list file on console 
Header record 
Data record 
End-of-file 


= (control A) 

♦MACSBOG* 

♦READ ;=COPY FILE, MX, #C 
♦DM EOO 

OOOEOO 70 01 70 02 70 03 

♦PC EOO 

♦TD CLEAR 

♦TD PC.2D0.1 

♦TD 

PC-OEOO DO-00 
♦BR E04 
♦T TILL 0 
PC=0E02 D0=01 
PC-0E04 D0=02 
♦GO 

PC»0E04 D0*02 


Ends transparent mode 

Message put out by MACSbug to indicate user is 
now in MACSbug command mode 

Download from EXORciser host (see sec, 1,6.12) 
Display memory (see sec, 1.6,2) 

70 04 70 05 4E P8 OE 00 FP FF 

Set program counter to START (see sec, 1,6,1) 
Clear the trace display (see sec, 1,6,7) 

Specify which registers to print in display 
Print the trace display 

Set a breakpoint 
Trace command 

Stopped at breakpoint 

Stopped at breakpoint 
Program is ready to run 


(see sec. 1.6,6) 
(see sec, 1,6.9) 

(see sec, 1,6.6) 



1.8 I/O SPECIFICATIONS 


Provisions have been made for the user to substitute his own I/O routines 
and direct the I/O for some commands to these routines. There are three 
pairs of locations in RAM that hold the addresses of the I/O routines. 

(See paragraph 1,11 on the equate file of RAM locations used by MACSbug. ) 
They are initialized when the system is booted to contain the addresses of 
the default routines in MACSbug ROMs. 

INPORTl and OOTPORTl are defaulted to port 1 which is MACSbug' s console. 

The MACSbug prompt, command entry, all error messages, and all other 
unassigned I/O use these addresses to find the I/O routines. Most 
commands do not need a port specifier to use PORT 1. The REad and VErify 
commands, however, default to PORT 2, 

INPORT2 and ODTPORT2 are defaulted to port 2 which is the host system (an 
EXORciser or timesharing system, etc.). Output or input is directed to 
this port by including a port specifier in the command field of the 
command line. 

For example: *RE2;-C 

The 2 in the command RE2 specifies that the addresses for the I/O routines 
will be found in the RAM locations INPDT2 and ODTPUT2. Error messages, 
however, will be printed on PORT 1 - MACSbug's console, 

INPORT3 and ODTPORT3 are inititalized to the same routine addresses as PORT 
1 when the system is booted. The user can insert the addresses of his own 
I/O routines into these locations. I/O can then be directed to his 
configuration by using a 3 in the command field. 


EXAMPLES 


COMMENTS 


*READ3;-C 
♦VERIFYl 
*DM2 50 80 


Memory load from port 3; checksum ignored 

Verify memory with *S* records coming in from PORT 1 

Display memory sending output to PORT 2 


The BAUD rates of the two RS-232C serial ports can be changed by setting 
memory locations $06BA and $06BC. 


ADDRESS 

$06BA 

$06BC 


PORT VALUE 

1 IX 

2 IX 


The Hex digit X can be set to select various BAUD rates as shown below: 


X 

BAUD RATE 


6 

300 


7 

600 


SAC 
1200 2400 4800 


E F 

9600 19200 


EXAMPLES 


COMMENTS 


SM 6BA 16 
SM 6BC IF 


Set BAUD rate to 300 for port 1 
Set BAUD rate to 19200 for port 2 



1.9 USER I/O THROUGH TRAP 15 
Format in user program: 


TRAP #15 Call to MACSbug trap handler 

DATA.W function Valid functions listed below. 

Program resumes with next instruction. 


FUNCTION 

DESTINATION 

FUNCTION 

BUFFER 

0 


Coded Breakpoint 



1 

PORTl console 

Input line 

A5=A6 

is start of buffer, 

2 

PORTl console 

Output line 

A5 to 

A6-1 is buffer. 

3 

PORT2 host 

Read line 

A5=A6 

is start of buffer, 

4 

PORT2 host 

Print line 

A5 to 

A6“l is buffer. 


EXAMPLE PROGRAM: 


1 * 

2* ; file : MBDG.EX.TEXT 

3 * 

4* ; Example of using TRAP #15 facility in 

5* ; MacsBug. This progreira is assembled with 

6* ; ASM68K then linked using the Concept 

7* ; LINKER, It was executed by calling out 

8* ; the code file. 

9* ; 

10* ; COMMAND LINE: COMMENT: 

11* 7 asm68k mbug.ex assemble file 

12* 7 linker mbug.ex link 

13* 7 mbug.ex execute 

14* T 
15* 

16* 

0000 4BFA 001A+ 17* START LEA BUFFER, A5 7 lnit buffer 

0004 2C4D 18* MOVEA.L A5, A6 7Pointers 

19* 

20* 7 Input buffer from Port 1 

21 * 7 

0006 4E4F 22* TRAP #15 7 echoes input 

0008 0001 23* DATA.W 1 

24* 

25* 7 Output buffer to Port 2 

26* 7 
27* 


OOOA 4E4F 


TRAP 


#15 



oooc 

0004 

28* 

DATA.W 

4 



29* 





30* 

; Enter MacsBug 



31* 

? 


OOOE 

4E4P 

32* 

TRAP 

#15 

0010 

0000 

33* 

DATA.W 

0 



34* 





35* 

; if first char 

in buffer 



36* 

• 


0012 

7021 

37* 

MOVEQ 

#• 1 ' ,D0 

0014 

B03A 0006+ 

38* 

CMP.B 

BUFFER, : 

0018 

66E6 

39* 

BNE.S 

START 



40* 



OOIA 

4E7 5 

41* 

RTS 




42* 





43* 

; BUFFER 




44* 

; 


OOlC 

00000000 

45* 

BUFFER DATA.L 

0,0, 0,0,1 

0054 

00000000 

46* 

DATA.L 

0 ,0 ,0 ,0 , 

008C 

00000000 

47* 

DATA.L 

0 ,0,0,0, 



48* 




00000000+ 

49* 

END 

START 


coded breakpoint 


"I" then exit 


;lst char = " I " 
;no, do again 


, 0 . 0 , 0 , 0 , 0 , 0 , 0,0 
, 0 , 0 , 0 , 0 , 0 , 0 , 0,0 
, 0 , 0 , 0 , 0 , 0 , 0 , 0,0 


BUFFER 


00001C+ START 


000000 + 



1.10 GENERAL INFORMATION 


TRAP ERROR is the general message given when an unexpected trap occurs. 
Nearly all of the low vectors including the user traps, interrupts, divide 
by zero, etc. are initialized during booting to point to this simple error 
routine. No attempt is made to decipher which trap happened, but the user's 
registers are saved. The system usually retrieves the right program counter 
from the supervisor stack but some exception traps push additional informa- 
tion on to the stack and the system will get the program counter from the 
wrong place. It is recommended that the user's program reinitialize all 
unused vectors to his own error handler. 

The REad command may have problems in some configurations. No attempt is 
made to control the equipment sending the information. When the system 
recognizes the end of a line it must process the buffer fast enough to be 
able to capture the first character of the next line. Normally the system 
can download from an EXORciser at 9600 baud. If the system is having 
problems, it might be worthwhile to experiment with lower BAUD rates. 

The REad routine DOES NOT protect any memory locations. The routine will 
not protect itself from programs trying to overlay the I/O buffer. This 
will, of course, lead to errors during the download. Any location in memory 
can be loaded into, including MACSbug' s RAM area. This allows the user to 
initalize such locations as the starting and ending address of the symbol 
table. All the registers may be initialized except the program counter 
which takes its address from the S8 or S9 record. 

The REad command, supports the normal SO, Si, S2, S8 . and S9 record formats. 
(See Appendix for a description of these S Records.) 

TRAP 15 is used by both the user I/O feature and breakpoints. When the 
program is running, the address of the breakpoint routine is normally in 
the TRAP 15 vector. When program execution is stopped, the I/O routine 
address is normally inserted into TRAP 15 vector. If I/O is not needed 
in the program, the user may change the vector with the SM command. If 
breakpoints are not needed, the program may change the vector while the 
program is running. It is recommended, however, that the user should use 
the other 15 vectors (or other programming techniques) and let MACSbug 
control TRAP 15. 



1.11 EQUATE FILE OF RAM USED BY 68000 MACSbug 2.0 


* WARNING TO USER: The addresses listed below and their usage as described 

in this document are intended for only this version (2.0) of MACSbug. 

Corvus does not guarantee the usage of these locations. 




ORG $400 


400 

REGPC 

DS.L 

1 

USERS PROGRAM COUNTER 

404 

REG SR 

DS.L 

1 

USERS CONDITION CODES 

408 

REGS 

DS.B 

4*2*8 

4 BYTES *3 SECTIONS *8 REG (OR MEM) 

444 

REGA7 

EQU REGS+60 

WHERE A7 REG IS 

448 

REG US 

DS.B 

4 

USER STACK 

44C 

OFFSET 

DS.L 

1 

ASSUMED OFFSET 

450 

FORMAT 

DS.B 

36 

TRACE DISPLAY FORMATS 

474 

ADALL 

DS.L 

1 

SPECIAL FORMAT FLAGS 

478 

WINDOWS 

DS,B8*8 

WINDOW PARAMETERS 

4B8 

LOOPRl 

DS.L 

1 

LOW RANGE FOR LOOP FEATURE 

4BC 

LOOPR2 

DS.L 

1 

HIGH RANGE FOR LOOP FEATURE 

4C0 

BPADD 

DS.L 

8 

BREAKPOINT ADDRESSES 

4EO 

BPTILL 

DS.L 

1 

TEMPORARY BREAKPOINT 

4E4 

BPCNT 

DS.L 

9 

BREAKPOINT COUNTS 

508 

BPDATA 

DS.W 

9 

HOLD USER WORDS REPLACED BY TRAP IN SET 

51A 

SAVETRAP 

DS.L 

1 

HOLDS USER'S TRAP 15 VECTOR 

51E 

NULLPADS 

DS.B 

2 

CHARACTER NULL PADS 

520 

CRPADS 

DS.B 

2 

CARRIAGE RETURN NULL PADS 

522 

SB IT 

DS.B 

2 

STOP BITS (ACIA PROGRAM) 

524 

OUTTO 

DS.B 

4 

HOLDS ADDRESS OF OUTPUT ROUTINE 

528 

INFROM 

DS.B 

4 

HOLDS ADDRESS OF INPUT ROUTINE 

52C 

ALTACIAl 

DS.L 

1 

ALTERNATE ACIA PORT#l 

530 

ALTACIA2 

DS.L 

1 

ALTERNATE ACIA PORT #2 

534 

INPORTl 

DS.L 

1 

INPUT ROUTINE ADDRESS 

538 

OUTPORTl 

DS.L 

1 

ADDRESS FOR OUTPUT ROUTINE 

53C 

INPORT2 

DS.L 

1 

ADDRESS FOR INPUT ROUTINE 

540 

OUTPORT2 

DS.L 

1 

FOR OUTPUT ROUTINE 

544 

INPORT3 

DS.L 

1 

PORT #3 INPUT ROUTINE 

548 

OUTPORT3 

DS.L 

1 

PORT #3 OUTPUT ROUTINE 

54C 

TRACECNT 

DS.L 

1 

TRACE COUNTER 

550 

TRACEON 

DS.W 

1 

FLAG FOR TRACE ON 

552 

RUN 

DS.W 

1 

1=SAVE USER REGISTERS ;0=NOT 

554 

BPSTATUS 

DS.W 

1 

laBP ARE IN? 0=ARE OUT OF MEMORY 

556 

SCREENl 

DS.L 

1 

PRINT THIS BEFORE TRACE DISPLAY 

55A 

SCREEN2 

DS.L 

1 

PRINT THIS AFTER 

55E 

BASE 

DS.B 

2 

WORK VARIABLE 

560 

SIGN 

DS.B 

2 

WORK VARIABLE 

562 

VECTOR 

DS.B 

2 

WORK VARIALBE 

564 

TEMP 

DS.B 

4 

WORK SPACE 

568 

WORKl 

DS.L 

1 

WORK SPACE 

56C 

WORK2 

DS.L 

1 

WORK SPACE 

570 

STRSYM 

DS.L 

1 

START OP SYMBOL TABLE 

574 

ENDSYM 

DS.L 

1 

END OP SYMBOL TABLE 

578 

CHDTABLE 

DS.L 

1 

START OP COMMAND TAB 

57C 

BUFFER 

DS.B 

$128 

WORKING STORAGE BUFF 

6A4 


DS.B 

20 

ROOM FOR STACK 

6B8 

SYS TACK 

DS.B 

2 

START OF STACK (GOES DOWN) 




Appendix A 

S RECORDS 

An S record is a standard Motorola record format used in downloading 
programs and data with MACSbug. 

There are ten possible standard S record typesr five of which can be used 
with MACSbug, They are as follows: 


SO 

Header 

record 





SI 

16 

bit 

address 

Data 

record 



S2 

24 

bit 

address 

Data 

record 



S8 

24 

bit 

address 

End 

of File/Execution 

Address 

record 

S9 

16 

bit 

address 

End 

of File/Execution 

Address 

record 


The standard S record is defined as follows: 






BYTE 

CHECK 

FRAME 

VALUE 

DESCRIPTION 


COUNTED 

SUMMED 

1 

$53 (S) 

Start of Record 




2 

$3Q-$39 (0-9) 

Record Type 




3,4 


Byte Count 



* 

5-8 


Address (for 16 

bit) 

* 

* 

5-10 


Address (for 24 

bit) 

* 

* 





* 

* 



Data 


* 

* 





* 

■k 

N-1,N 


Checksum 


* 



The letter "S" and the Record Type are represented directly in ASCII, 

The byte count, address, data, and checksum are represented in ASCII 
encoded hexadecimal; i.e., two frames per data byte, with the most 
significant digit in the leading frame. 

The checksum is the l*s complement of the sum of all 8-bit data/address 
bytes from byte count to last data byte, inclusive. 

TYPICAL OBJECT S-RECORD FORMAT 
S00600004844521B 

S1131000307C1000327C1FFE123C00804280428300 

S1131010383C09964A016A0000121A18BOC96600E1 

S1131020000AD2FC00026000002EE3113400E352F7 

S11310300242000BE30D050466000006E25860D48A 

S1131040E2580840000F60CC4A016AOOOOOA1A18EE 

S1131050BOC96700002AE3113400E3520242000BD6 

S113106005046600000CE35B08C300006000000890 

S1131070E35B08830000E25808COOOOF60CA31C374 

S10710801FFE4E728B 

S00600004844521B 

S20A010000323C00035641ED 

S9030000FC 



First two characters - SO Starts of the first record. 

- SI Indicates that the object data that 

follows will be at a two-byte 

memory address. 

- S2 Same as SI, but indicates a three- 

byte memory address. 

- S8 Same as S9 , but indicates a three- 

byte memory address. 

- S9 Last Record 

Third and fourth characters - Hexadecimal byte count of the remaining 

characters in the record. 

Fifth through eighth characters - Hexadecimal memory address where the 

data that follows is to be loaded. If 
the record is "52" or "S8" type, the 
fifth through tenth characters contain 
the memory address. 

Last two characters - Checksum of all characters from byte 

count to the end of data. 



